RESTμ κ°λ μ λν΄μ μ 리νλ POSTμ λλ€.
π§ REST
βοΈ RESTμ μ μ
: "Representational State Transfer"μ μ½μλ‘, μμμ μ΄λ¦μΌλ‘ ꡬλΆνμ¬ μμμ μνμ 보λ₯Ό μ£Όκ³ λ°λ λͺ¨λ κ²μ μλ―Ένλ€.
- HTTP URIλ₯Ό ν΅ν΄ μμμ λͺ μνκ³ ,
- HTTP Method(POST, GET, PUT, DELETE)λ₯Ό ν΅ν΄ ν΄λΉ μμ(URI)μ λν CRUDλ₯Ό μ μ©νλ κ²μ΄λ€.
π© κ΅¬μ± μμ
- μμ : HTTP URIμ νν
- μμμ λν νμ : HTTP Method
- μμμ λν νμμ λ΄μ© : HTTP Message payload
π νΉμ§
- Server-Client(μλ²-ν΄λΌμ΄μΈνΈ ꡬ쑰) : REST μλ²λ API μ 곡, ν΄λΌμ΄μΈνΈλ μ¬μ©μ μΈμ¦μ΄λ Context(session, λ‘κ·ΈμΈ μ 보) λ±μ μ§μ κ΄λ¦¬νλ ꡬ쑰λ‘, κ°κ°μ μν μ΄ νμ€ν ꡬλΆλκΈ° λλ¬Έμ ν΄λΌμ΄μΈνΈμ μλ²μμ κ°λ°ν΄μΌ ν λ΄μ©μ΄ λͺ νν΄μ§κ³ μλ‘ κ° μμ‘΄μ±μ΄ μ€μ΄λ€κ² λλ€.
- Stateless(무μν) : RESTλ μνλ₯Ό κ°μ§μ§ μλλ€. μ¦ μμ μ μν μνμ 보λ₯Ό μ μ₯νκ±°λ κ΄λ¦¬νμ§ μλλ€. μμμ μ€λͺ νλ―, μλ²λ session μ 보λ μΏ ν€ μ 보λ₯Ό λ³λλ‘ μ μ₯νκ³ κ΄λ¦¬νμ§ μκΈ°μ λ¨μν λ€μ΄μ€λ μμ²λ§μ μ²λ¦¬νλ ꡬ쑰μ΄λ€. λ°λΌμ μλΉμ€μ μμ λκ° λμμ§κ³ μλ²μμμ ꡬνμ΄ λ¨μν΄μ§λ€.
- Cacheable(μΊμ μ²λ¦¬ κ°λ₯)
: HTTPλΌλ κΈ°μ‘΄ μΉ νμ€μ κ·Έλλ‘ μ¬μ©νκΈ°μ, μΉμμ μ¬μ©νλ κΈ°μ‘΄ μΈνλΌλ₯Ό κ·Έλλ‘ νμ©ν μ μλ€. μ¦, HTTPκ° κ°μ§ μΊμ± κΈ°λ₯μ μ μ©ν μ μλ€. (
Last-ModifiedorE-Tagμ¬μ©) - Layered System(κ³μΈ΅ν) : REST μλ²λ λ€μ€ κ³μΈ΅μΌλ‘ ꡬμ±λ μ μμΌλ©°, 보μ, load balancing, μνΈν κ³μΈ΅μ μΆκ°ν΄ μ μ°μ±μ λ μ μλ€. λν PROXY, Gateway κ°μ λ€νΈμν¬ κΈ°λ°μ μ€κ° 맀체λ₯Ό μ¬μ©ν μ μκ² νλ€.
- Uniform Interface(μΈν°νμ΄μ€ μΌκ΄μ±) : μμμ μΈκΈνλ―, HTTP νμ€μ λ°λ₯΄κΈ°μ νΉμ μΈμ΄λ κΈ°μ μ μ’ μλμ§ μκ³ λͺ¨λ νλ«νΌμ μ¬μ©ν μ μμΌλ©°, URIλ‘ μ§μ ν μμμ λν μ‘°μμ΄ κ°λ₯νλ€.
π μ₯λ¨μ
μ₯μ
-
HTTP μΈνλΌλ₯Ό κ·Έλλ‘ μ¬μ©νλ―λ‘ REST API μ¬μ©μ μν λ³λ μΈνλΌ κ΅¬μΆμ΄ νμνμ§ μλ€.
- λν, HTTP νμ€μ μ΅λν νμ©νμ¬ μ¬λ¬ μΆκ° μ₯μ μ κ°μ§λ€.
- HTTP νμ€μ λ°λ₯΄λ λͺ¨λ νλ«νΌμμ μ¬μ© κ°λ₯νλ€. (Uniform Interface)
-
Hypermedia API λ΄μμ, λ²μ©μ±μ 보μ₯νλ€.
-
Hypermedia API : λ€λ₯Έ λ§λ‘ HATEOAS(Hypermedia As The Engine Of Application State)λ‘, hypermediaλ₯Ό applicationμ μνλ₯Ό κ΄λ¦¬νκΈ° μν 맀컀λμ¦μΌλ‘ μ¬μ©νλ€λ κ°λ μ΄λ€. REST API ꡬνμ λ§μ§λ§ λ¨κ³λ‘, API κ΄λ¦¬μ μ΄λ €μμ΄ μλ€λ©΄ λμ μ κ³ λ €ν΄λ³Όλ§νλ€.
-
- REST API λ©μΈμ§κ° μλνλ λ°λ₯Ό λͺ ννκ² λνλ΄κΈ°μ μλλ₯Ό νμ νκΈ° μ½λ€.
- μλ²μ ν΄λΌμ΄μΈνΈμ μν μ λͺ ννκ² λΆλ¦¬νλ€.
λ¨μ
- νμ€μ΄ μ‘΄μ¬νμ§ μμ μ μκ° νμνκ³ κ΄λ¦¬κ° μ½μ§ μλ€.
- μ¬μ©ν μ μλ λ©μλκ° 4κ°μ§λΏμ΄λ€. (HTTP λ©μλκ° μ νμ )
-
μν°ν¨ν΄μΌλ‘ μ€κ³λ κ°λ₯μ±μ΄ μλ€.
-
μν°ν¨ν΄ : νμ€μ΄ μκΈ°μ REST APIμ΄ νΉμ§μ μ΄ν΄νμ§ λͺ»νκ³ μ΄κΈλλ ν¨ν΄ HTTP λ©μλμ μλͺ»λ μ¬μ©, HTTP Response codeμ μ νμ νμ©μ΄ μμΈμ΄ λ μ μλ€.
-
π¨ REST API
π§ REST APIμ μ μ
: RESTλ₯Ό κΈ°λ°μΌλ‘ λ§λ€μ΄μ§ API
π¦ νΉμ§
- REST κΈ°λ°μΌλ‘ μμ€ν μ λΆμ°ν΄ νμ₯μ±κ³Ό μ¬μ¬μ©μ±μ λμ¬ μ μ§λ³΄μ λ° μ΄μ©μ΄ νΈλ¦¬ν΄μ§λ€.
- HTTP νμ€μ κΈ°λ°μΌλ‘ ꡬνν΄, HTTPλ₯Ό μ§μνλ νλ‘κ·Έλ¨ μΈμ΄λ‘ ν΄λΌμ΄μΈνΈμ μλ²λ₯Ό ꡬνν μ μλ€.
π― μ€κ³
κΈ°λ³Έ κ·μΉ
- URIλ μ 보μ μμμ νννλ€.
- μμμ λν νμλ HTTP λ©μλλ‘ νννλ€.
μμ
| CRUD | HTTP λ©μλ | Route |
|---|---|---|
| μμλ€μ λͺ©λ‘μ νμ | GET | /resource |
| μμ νλμ λ΄μ©μ νμ | GET | /resource/:id |
| μμ μμ± | POST | /resource |
| μμ μμ | PUT | /resource/:id |
| μμ μμ | DELETE | /resource/:id |
β RESTful
π³ RESTfulμ μ μ
: μΌλ°μ μΌλ‘ RESTλΌλ μν€ν μ²λ₯Ό ꡬννλ μΉ μλΉμ€ (REST APIλ₯Ό μ 곡νλ μΉ μλΉμ€)
- RESTfulν APIλ₯Ό ꡬννλ κ·Όλ³Έμ μΈ λͺ©μ μ μ±λ₯ ν₯μμ΄ μλ μΌκ΄μ μΈ μ»¨λ²€μ μ ν΅ν APIμ μ΄ν΄λ λ° νΈνμ±μ λμ΄λ κ²μ΄λ€. λ°λΌμ μ±λ₯μ΄ μ€μν κ²½μ° κ΅³μ΄ μ΄λ₯Ό ꡬνν νμλ μλ€.
π£ RESTfulνμ§ λͺ»ν κ²½μ°
- CRUD κΈ°λ₯μ λͺ¨λ POSTλ‘λ§ μ²λ¦¬νλ κ²½μ°, μ¦ HTTP λ©μλλ₯Ό λͺ¨λ νμ©νμ§ μλ κ²½μ°
- Routeμ resource, id μΈμ μ λ³΄κ° λ€μ΄κ°λ κ²½μ°(ex.
/students/updateName)